home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / chat / phone.arc / PHONE.DOC < prev    next >
Text File  |  1989-03-19  |  20KB  |  424 lines

  1.  
  2.  
  3.  
  4.         
  5.         
  6.         
  7.         
  8.         
  9.         
  10.         
  11.         
  12.         
  13.         
  14.         
  15.         
  16.         
  17.         
  18.                                    Phone v2.0x
  19.                Network Interactive Conversation and File Transfer
  20.         
  21.                               Copyright 1987-89 by
  22.                     Programming Unlimited and Citadel Systems
  23.         
  24.                                  Citadel Systems
  25.                                   10 Ely Place
  26.                                    P. O. Box 5
  27.                                Simsbury, CT 06070
  28.                                  (203) 651-5376
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.         
  36.                                       What is Phone?
  37.         
  38.                 Phone is a Local Area Network program designed 
  39.              specifically for use with Novell networks.  The program 
  40.              allows interactive chat-style conversations between users on 
  41.              the LAN.  Conversations can be started between any two users 
  42.              on a NetWare LAN, including those which are bridged 
  43.              internally or externally with NetWare bridges.  In addition 
  44.              to conversations, Phone performs file transfer between 
  45.              workstations.
  46.         
  47.                 The main difference between Phone and other chat-style 
  48.              programs is that Phone conversations take place character by 
  49.              character.  That is, as each character is typed on the 
  50.              sending station the receiving station displays it.  This 
  51.              makes life much more interesting than sentence based 
  52.              programs.  Phone also performs file transfer between 
  53.              workstations.  The transfer can be initiated by either 
  54.              station, and the non-initiating station has the option of 
  55.              aborting the process.
  56.         
  57.                 Phone is very simple to use.  All program input can be 
  58.              entered via the NetWare style Opening Menu, or the desired 
  59.              callee can be specified on the command line in standard 
  60.              NetWare notation.
  61.         
  62.         
  63.                                    How to Install Phone
  64.         
  65.                 Phone can be installed on any network drive by using the 
  66.              normal DOS COPY command, or the Netware equivalent NCOPY 
  67.              command.  The following set of instructions will install 
  68.              Phone under the PUBLIC subdirectory.  Here we are assuming 
  69.              that SYS:PUBLIC is mapped to the Z: drive, as this is the 
  70.              default mapping for Netware.  If this is not the case, or you 
  71.              do not wish to install Phone in the PUBLIC directory, then 
  72.              simply substitute the appropriate drive letter for your case.  
  73.              Each command is followed by pressing the <enter> key.
  74.         
  75.              1)  Make SYS:PUBLIC the default drive.  
  76.                  Type Z:
  77.         
  78.              2)  Copy the Phone files into PUBLIC.  
  79.                  Type NCOPY A:*.* Z:*.*
  80.         
  81.              3)  Make Phone a read-only file.  
  82.                  Type FLAG Z:PHONE.EXE SRO
  83.         
  84.              4)  Make WHEREIS a read-only file.  
  85.                  Type FLAG Z:WHEREIS.EXE SRO
  86.         
  87.              5)  Delete LAN-MORE.COM from PUBLIC.  
  88.                  Type DEL Z:LAN-MORE.COM
  89.         
  90.                 The Phone files are now installed in the PUBLIC directory.
  91.         
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.                                      How to Run Phone
  99.         
  100.                 Phone is invoked by typing PHONE server/user at the DOS 
  101.              prompt and pressing <enter>, or just typing PHONE and 
  102.              pressing <enter>.  Any two users who wish to PHONE each other 
  103.              must be logged into or attached to at least one common 
  104.              fileserver.  For the following example, you are logged into 
  105.              FS1 as AL and you want to call the user DAVE who is also 
  106.              logged into fileserver FS1.  The F: drive is mapped to some 
  107.              directory on FS1, and PHONE either exists on that directory, 
  108.              or is located on a search drive.
  109.         
  110.         
  111.                   F: PHONE
  112.         
  113.                 Using the above form of the command will bring up the 
  114.              Opening Menu.  This is a NetWare style menu from which you 
  115.              may change servers, select a user, enter a fileserver/user 
  116.              name combination by hand, or cause a call to be placed.  You 
  117.              may also exit the opening menu by pressing the Escape (Esc) 
  118.              key.  The top of the menu shows the current default 
  119.              fileserver and the user name you are logged in as on that 
  120.              server.  A menu choice is selected by using the cursor keys 
  121.              to highlight a choice, and pressing <enter>, or by typing 
  122.              successive characters of the choice you want and pressing 
  123.              <enter>.
  124.         
  125.                 Selecting the "Change Current Server" entry will present 
  126.              you with a list of the fileservers to which you are currently 
  127.              attached.  To select a new server, highlight the desired 
  128.              entry and press <enter>.  To keep the same server, press 
  129.              <esc>.
  130.         
  131.                 Choosing "Select User From List" will present you with a 
  132.              list of users who are logged into the current server.  To 
  133.              select a new user, highlight the desired entry and press 
  134.              <enter>.  You may use either the cursor keys or type 
  135.              successive letters of the user name you want to highlight the 
  136.              proper entry.  If the list can't fit on the screen, then the 
  137.              list will scroll as needed.  Note that by using this method 
  138.              you can only choose one user-station combination at a time.  
  139.              If a user is logged in more than one time, then only the 
  140.              station number selected here will be notified.  If you wish 
  141.              to send call notification to every station that a user is 
  142.              logged into, then you must use the "Enter User by Hand" 
  143.              entry.
  144.         
  145.                 Selecting the "Enter User by Hand" entry will allow you to 
  146.              type in a fileserver/user name combination without having to 
  147.              use the other menu entries.  When the entry box appears, type 
  148.              the user name in the form of FILESERVER/USER, or 
  149.              FILESERVER/*.  The FILESERVER part of the entry can be 
  150.              omitted if the user exists on the current server.  If the 
  151.              user selected at this point is logged in more than once, then 
  152.              all stations to which he is logged in will be notified of 
  153.              your desire to establish a Phone conversation.  The 
  154.              FILESERVER/* form can be used to change servers without  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.              choosing from one of the opening menu entries.
  162.         
  163.                 Choosing "Place Call" causes Phone to try to find and 
  164.              notify the user selected by one of the previous methods that 
  165.              a Phone conversation is desired by you.  If no user was 
  166.              selected, then an error message to that effect will be 
  167.              displayed.
  168.         
  169.         
  170.                   F: PHONE  FS1/DAVE
  171.         
  172.                 Using the preceeding form of the command, Phone will send 
  173.              a NetWare SEND style message to DAVE on FS1 and wait for a 
  174.              reply.  If DAVE is logged into more than one station, then 
  175.              all his stations will be notified of your intention to 
  176.              establish a Phone conversation.  If DAVE is not logged into 
  177.              FS1, then a message stating so will be displayed.  If the 
  178.              fileserver FS1 does not exist, then a message will be 
  179.              displayed.  Pressing any key will clear either of the two 
  180.              above error messaged.  If DAVE is logged on FS1, but does not 
  181.              reply in what you consider a timely manner, you can press 
  182.              <esc> to abort the call.  This will leave you at the opening 
  183.              menu where you may enter another user name or exit the 
  184.              program.
  185.         
  186.         
  187.                   F: PHONE  DAVE
  188.         
  189.                 Using the above form of the command, Phone will send a 
  190.              NetWare SEND style message to DAVE on your current server and 
  191.              wait for a reply.  If DAVE is logged into more than one 
  192.              station, then all his stations will be notified of your 
  193.              intention to establish a Phone conversation.  If DAVE is not 
  194.              logged into the current server, then a message stating so 
  195.              will be displayed and you will be returned to the opening 
  196.              menu.  If DAVE does not reply in what you consider a timely 
  197.              manner, you can press <esc> to abort the call.  Doing so will 
  198.              leave you at the opening menu where you may enter another 
  199.              user name or exit the program.
  200.         
  201.         
  202.                 There is also another form of the command.
  203.         
  204.                   F: PHONE FS2/*
  205.         
  206.                 Using this form of the command, Phone will try to make FS2 
  207.              the current server and display the opening menu.  From this 
  208.              point you use the opening menu as described above.  Note that 
  209.              to use this form of the command, you must be logged into FS2, 
  210.              or a message stating that FS2 does not exist will be 
  211.              displayed.
  212.         
  213.                 In the event that DAVE is logged in multiple times, and 
  214.              the notification message is sent to every station where Dave 
  215.              is logged in, the first station that calls back will be the 
  216.              one with which a connection will be made.  In the event that 
  217.              two stations logged in as DAVE answer at EXACTLY the same  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.              time, the one with the lower logical station number will make 
  225.              the connection.  If you don't want to alert every station 
  226.              where DAVE is logged in, and only want to alert the station 
  227.              where Dave is actually sitting, then the last form of the 
  228.              PHONE command may be used.  Here we assume that DAVE is 
  229.              logged into FS1 at station numbers 7, 10, and 14, and we want 
  230.              to talk to the real Dave who is sitting at station 10.
  231.         
  232.                 F: PHONE FS1/10
  233.         
  234.                 In situtations such as these, it is recommended that you 
  235.              use the WHEREIS command (described below) or the NetWare 
  236.              USERLIST command to try to determine exactly which station it 
  237.              is you want to contact.
  238.         
  239.                 In any of the above cases DAVE will get a message similar 
  240.              to the following:
  241.         
  242.                   Please PHONE FS1/AL     10:30:15
  243.         
  244.                 If DAVE is inclined to answer, he can type
  245.         
  246.                   PHONE AL
  247.         
  248.                 And the connection between the two machines will be made.
  249.         
  250.         
  251.                 PLEASE NOTE THAT THE NetWare SEND STYLE MESSAGE THAT IS 
  252.              USED TO ALERT POTENTIAL PHONE RECIPIENTS LOCKS THE RECEIVING 
  253.              MACHINE UNTIL THE USER PRESSES <cntl-enter>.  IF YOU TRY TO 
  254.              PHONE A USER WHO IS NOT AT HIS MACHINE, IT WILL REMAIN LOCKED 
  255.              UNTIL HE RETURNS AND PRESSES <cntl-enter>.
  256.         
  257.         
  258.                                  Once The Connection Is Made
  259.         
  260.                 The internal process of making a connection between two 
  261.              stations running Phone involves the stations exchanging 
  262.              version information.  This is done to ensure that 
  263.              incompatible versions of Phone do not begin to talk to each 
  264.              other and possibly cause problems.  If the version check is 
  265.              successful, then a split screen will appear.  On the top 
  266.              screen will appear the side of the conversation of the user 
  267.              at that station, and the other user's conversation will 
  268.              appear on the bottom.  You may type freely, use the backspace 
  269.              key, and all the cursor movement keys.  You may move about 
  270.              your own window without restriction.  If you try to type past 
  271.              the edge of the box, automatic wrap to the next line occurs.  
  272.              Whatever you type on your screen, the other user will see on 
  273.              his screen.  Both users may type at the same time.  Aside 
  274.              from the alphabetic keys, the following keys are active.  
  275.         
  276.                 <Home> - causes your conversation area to be cleared, and 
  277.              the cursor sent to the top left corner.
  278.         
  279.                 Cursor Keys - cause the cursor to move in the direction of 
  280.              the arrow.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.         
  288.                 ^G (CTRL-G) - makes a beeping sound on both machines.
  289.         
  290.                 <F1> - displays a HELP screen.
  291.         
  292.                 Alt S - starts a file transfer SEND operation.
  293.         
  294.                 Alt R - starts a file transfer RECEIVE operation.
  295.         
  296.         
  297.                                         File Transfer
  298.         
  299.                 Either workstation can initiate both SEND and RECEIVE 
  300.              operations.  SEND will transfer a file from your PC to the 
  301.              other PC, and RECEIVE will transfer a file from the other PC 
  302.              to your PC.
  303.         
  304.                 SEND: To initiate a SEND operation, type Alt S (hold down 
  305.              the <Alt> key while you press S).  The "File Transfer (Send)" 
  306.              operation box will appear on your screen, while the "File 
  307.              Transfer (Receive)" operation box will appear on the other 
  308.              PC's screen.  At this time, the keyboard of the other PC is 
  309.              inactive.  It remains inactive until the transfer is about to 
  310.              begin, at which time it becomes active so that the other user 
  311.              may abort the transfer.  Now you may begin entering the two 
  312.              peices of information needed for the file transfer.  The 
  313.              "File to be sent" is the name of the file which you want to 
  314.              transfer to the other machine, and "Remote file name" is the 
  315.              name of the file created on the other end.  If you type the 
  316.              name of a file that does not exist in the "File to be send" 
  317.              field, then an error message will be displayed and you will 
  318.              be prompted to enter another name.  The "File size" field 
  319.              will be filled in automatically.  As the file is transferred, 
  320.              the "Transferred" field will reflect the number of bytes 
  321.              which have been transferred so far.
  322.         
  323.                 Filling in both filenames and pressing <enter> will begin 
  324.              the transfer.  Before the transfer actually takes place, 
  325.              however, the other party has a chance to abort it.  A message 
  326.              stating "Pressing any key in the next 5 secs will abort 
  327.              transfer" appears on the screen of the other PC, and "Waiting 
  328.              for confirmation from other machine" appears on your machine.  
  329.              If the remote user presses a key, then the transfer will be 
  330.              aborted, otherwise it will take place.
  331.         
  332.                 If you want to quit the SEND operation, there are two 
  333.              places to do so.  Entering no filename (pressing <enter> 
  334.              without typing a name) in either the "File to be sent" or the 
  335.              "Remote file name" field will abort the transfer.  Once you 
  336.              have entered two names and pressed <enter> the transfer will 
  337.              take place unless the other party aborts it.
  338.         
  339.                 RECEIVE: To initiate a RECEIVE operation, type Alt R (hold 
  340.              down the <Alt> key while you press R).  The "File Transfer 
  341.              (Receive)" operation box will appear on your screen, while 
  342.              the "File Transfer (Send)" operation box will appear on the 
  343.              other PC's screen.  At this time, the keyboard of the other 
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.              PC is inactive.  It remains inactive until the transfer is 
  351.              about to begin, at which time it becomes active so that the 
  352.              other user may abort the transfer.  Now you may begin 
  353.              entering the two peices of information needed for the file 
  354.              transfer.  The "File to be received" is the name of the file 
  355.              which you want to transfer from the other machine (the name 
  356.              of the file as it exists on the other machine), and "Local 
  357.              file name" is the name of the file created on your machine.  
  358.              If you enter the name of a file that does not exist in the 
  359.              "File to be received" field, then an error message will be 
  360.              displayed and you will be prompted to enter another filename.  
  361.              As the file is transferred, the "Transferred" field will 
  362.              reflect the number of bytes which have been transferred so 
  363.              far.
  364.         
  365.                 Filling in both filenames and pressing <enter> will begin 
  366.              the transfer.  Before the transfer actually takes place, 
  367.              however, the other party has a chance to abort it.  A message 
  368.              stating "Pressing any key in the next 5 secs will abort 
  369.              transfer" appears on the screen of the other PC, and "Waiting 
  370.              for confirmation from other machine" appears on your machine.  
  371.              If the remote user presses a key, then the transfer will be 
  372.              aborted, otherwise it will take place.
  373.         
  374.                 If you want to quit the RECEIVE operation, there are two 
  375.              places to do so.  Entering no filename (pressing <enter> 
  376.              without typing a name) in either the "File to be received" or 
  377.              the "Local file name" field will abort the transfer.  Once 
  378.              you have entered two names and pressed <enter> the transfer 
  379.              will take place unless the other party aborts it.
  380.         
  381.                                      The WHEREIS Utility
  382.         
  383.                 If you want to find out all the locations a user is logged 
  384.              into before invoking PHONE, you can use the WHEREIS utility.  
  385.              WHEREIS searches all attached fileservers for the username 
  386.              specified on the command line, for instance:
  387.         
  388.                 WHEREIS DAVE
  389.         
  390.                 will return every instance that DAVE is logged into all 
  391.              fileservers to which you are attached. This is especially 
  392.              useful if DAVE is logged in multiple times and you wish to 
  393.              PHONE him via his logical station number rather than his user 
  394.              name.
  395.         
  396.                 You can redirect the WHEREIS output to a DOS file by 
  397.              typing WHEREIS > FILENAME.EXT
  398.         
  399.                 You can redirect the WHEREIS output to the printer by 
  400.              typing WHEREIS > LPT1:
  401.         
  402.         
  403.         
  404.                                Command Line Specifications
  405.         
  406.                 The regular expression which describes the use of Phone 
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.              follows:
  414.         
  415.                 PHONE ((server/) ((station) | (user) | (*)))
  416.         
  417.                 Examples of legal invocations of PHONE follow:
  418.         
  419.                 PHONE
  420.                 PHONE FS1/*
  421.                 PHONE DAVE
  422.                 PHONE FS2/DAVE
  423.                 PHONE FS1/14
  424.                 PHONE 7